Skip to main content

List Datasets

Route

/v2/datasets

Description

Retrieve a list of all available datasets in your organization. Datasets define collections of data for classification and protection policies.

Method

GET

Inputs

ParameterTypeRequiredDescription
None--No parameters required

Output

FieldTypeDescription
typestringAlways "datasets"
sizeintegerNumber of datasets returned
resourcesarray[Dataset]Array of dataset objects
errorsarray[Error]Any errors encountered

Dataset Object Structure

FieldTypeDescription
idstringUnique dataset identifier
namestringHuman-readable name
descriptionstringDetailed description
sensitivitystringSensitivity level (unrestricted, low, moderate, high, critical)
domainstringDomain category (corporate, partner, personal, public)
created_atstringCreation timestamp (ISO 8601)
backfills_enabledbooleanWhether historical data processing is enabled

Rate Limit

  • 60 requests per minute per API key
  • 5 concurrent requests per endpoint

Example Response

{
"type": "datasets",
"size": 2,
"resources": [
{
"id": "dataset-123",
"name": "Customer PII",
"description": "Personal identifiable information of customers",
"sensitivity": "high",
"domain": "corporate",
"created_at": "2024-01-15T10:30:00Z",
"backfills_enabled": true
},
{
"id": "dataset-456",
"name": "Public Marketing",
"description": "Public marketing materials and content",
"sensitivity": "unrestricted",
"domain": "public",
"created_at": "2024-01-10T14:20:00Z",
"backfills_enabled": false
}
],
"errors": []
}